home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
ShareWare OnLine 2
/
ShareWare OnLine Volume 2 (CMS Software)(1993).iso
/
bbsdoors
/
wwmail44.zip
/
WWIVMAIL.DOC
< prev
next >
Wrap
Text File
|
1993-01-31
|
69KB
|
1,363 lines
▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒▄ ▒▒█ ▒▒▒▄▄▒▒▒▄ ▒▒▒▒▒▒▄ ▒▒▄ ▒▒▄
▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒█▒▒█▒▒█ ▒▒█▀▒▒█ ▒▒█ ▒▒█
▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▀▀▒▒█ ▒▒▒▒▒▒█ ▒▒█ ▒▒█
▒▒█▒▒▄▒▒█ ▒▒█▒▒▄▒▒█ ▒▒█ ▒▒▒▒█▀ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒█
▀▒▒▒▒█▀▀ ▀▒▒▒▒█▀▀ ▒▒█ ▒▒█▀ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒█ ▒▒▒▒▒▒▄
▀▀▀▀ ▀▀▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀ ▀▀▀▀▀▀
A .QWK Compatible Off-Line Mail Door For
The WWIV BBS System.
WWIVMail/QWK V4.4
Copyright (c)1993 By Michael Leib
with additional pieces (c) 1993 by Wayne Bell.
=================================================================
WARNING: WWIVMail/QWK v4.4 is ONLY for WWIV v4.22+ and
NET32+ ONLY( If your BBS is networked).
=================================================================
WARNING: If you are upgrading from a previous version of
WWIVMail or WWIVMail/QWK, please delete the wwivmail.usr user
file...the record size is different and the file should be
started clean.
=================================================================
Contents
========
WWIVQWK.EXE SUB NUMBER SELF-DETECTING WWIVMail/QWK EXECUTABLE.
WWIVMAIL.DOC DOCUMENTATION/HISTORY FOR/OF WWIVMail/QWK. (THIS FILE)
WWIVMAIL.CFG SAMPLE SYSOP CONFIGURATION FILE (OPTIONAL).
REGISTER.LST LISTING OF ALL CURRENTLY REGISTERED SYSOP/BBS BOARDS.
AND
QWK.LIB WWIVMail/QWK LIBRARY TO LINK WITH USERREC.CPP
QWKBCC.BAT .BAT FILE TO COMPILE AND LINK WWIVQWK.EXE(BC++ 2.0 or newer)
QWKTCC.BAT .BAT FILE TO COMPILE AND LINK WWIVQWK.EXE(TC++ 1.0 or newer)
RESPONSE RESPONSE FILE USED BY TLINK.EXE FOR LINKING OPTIONS/.OBJS/.LIBS
USERREC.H HEADER FILE FOR USERREC.CPP
USERREC.CPP CPP FILE TO COMPILE WITH YOUR VARDEC.H AND LINK WITH QWK.LIB
Introduction
============
There have been MANY changes in this version of WWIVMail/QWK, so
please take the time to read this documentaion. (To see EXACTLY what's
changed, see the end of this document for the Revision History of
WWIVMail/QWK).
So, for those who haven't looked at this program before, WWIVMail/QWK
(formally known as WWIVMail) is a fully .QWK (Q-Mail Packet (c)) Compatible
Off-Line Mail Door for the WWIV BBS System. It generates .QWK Mail packets
that can be read by a huge number of Public Domain/Freeware/ShareWare Mail
Readers and can accept response messages (.REP) from those readers and
incorporate those messages back into your WWIV BBS System.
I am not going to go into a long dissertation about the history
of .QWK Mail packets or about the structure thereof. Those questions
can be answered by reading the documentation in any .QWK compliant Mail
Reader. Let me just say that, as far as I know, WWIVMail/QWK is the first
.QWK Mail Door available for the WWIV BBS System. WWIVMail, in it's earlier
form, has been around for almost 2 years with great success. I am proud
to be the author of this software, and will continue to support it until
I die or Wayne Bell does. (Well, maybe till I create something better!)
WWIVMail/QWK supports all standard-documented features of the
original.QWK packet system as incorporated in the QMail(c) Mail System
approx 5+ years ago, as well as, the ADD/DROP Sub capability supported by
several .QWK readers. The standard support in WWIVMail/QWK includes System
Bulletins, Newsfile and an optional New Files Scan (which can be toggled
on and off by the user). This wasn't an easy task because of Wayne Bell's
WWIV(c) message base design; however, WWIVMail/QWK converts all STANDARD
WWIV messages and e-mail into standard .QWK format. (message.dat)
Personal E-mail, as well as all Public Posts, can also be uploaded
through WWIVMail/QWK in the .QWK stanadrd .REP response packet.
WWIVMail/QWK Also supports WWIV BBS Systems with Modified Userrec
vardec.h file structures by allowing you to compile your own version
with a freely distribulted .LIB created for Borland C++ 2.0/3.0/3.1 and
Turbo C++ 1.0 or newer.
(Full source code is available for download to registerred user's; however,
everything you need for a modified userrec structure is included in this
package).
Files in a .QWK Packet That WWIVMail/QWK Creates:
=================================================
HELLO => Openning BBS Welcome Screen
/* welcome.ans/.msg */
GOODBYE => Closing BBS Goodbye Screen
/* logoff.ans/.msg */
BBSNEWS => BBS News File
/* BBS News */
CONTROL DAT => BBS Message Subs/BBS Information Data File
/* WWIVMail/QWK generated */
DOOR ID => Information About WWIVMail/QWK
/* WWIVMail/QWK generated */
BLT-0 X => BBS Bulletins
/* WWIVMail/QWK generated. User Option */
.
.
.
MESSAGES DAT => All Messages For User To Read
/* WWIVMail/QWK generated */
000 NDX => Message Base Index Files (000-032/000-064)
/* WWIVMail/QWK generated */
.
.
.
NEWFILES.DAT => NewFiles Since User Last Logged-On
/* WWIVMail/QWK generated. User Option */
To see how to set the Sysop Options(mentioned above), see the information
below.
Features (Among A Cast Of 1000's)
========
(1) Built-in Communication routines( no need to monitor dos interrupts ).
Including Built-In support for hardware flow-control and, hence,
support for comm port speeds up to 38,400.
(2) Ansi color graphics support.
(3) Easy to use interface.
(4) Use of External Transfer Protocol Engines (Such as DSZ ((c) Omen
Technology)) to maintain high quality and compatibility among file
transfers.
See below for External Protocol documentation.
(5) Monitors Carrier Detect ( recycles back to the BBS ).
(6) 2 minutes time-out between keystrokes.
(7) On-line Help.
(8) All system security is maintained( user will NOT have access to any
message subs that they don't normally have access ) or be able
to Post on Subs that they are restricted from. Also, all Sysop
validation for Posts ( Net / User restrictions ) are maintained.
Also, the New Files scan option only looks at Transfer Section Areas
that the user has access to. (ie, AGE, DAR, AR, SL and DSL are
all checked ).
(11) Optional Newfiles Scan right in the DOOR!
(12) Full WWIV Multi-Net(WWIV 4.21a+) support capabilities built-in.
(13) Support for uptp 1024 SUBS/DIRS (Auto-Detecting).
(14) Support for Modified Userrec's!
(15) Supports ANY compression programs that the BBS does(.zip,.arc,etc)...
Very helpful for non-IBM users.
(16) Translates WWIV Colors into ANSI codes if the user desires.
(17) WWIVMail/QWK now supports the ability to import/export messages from
non-WWIV BBS systems via the .QWK packet. Hence, you can now
EASILY network your BBS without being restricted to a WWIV hosted
network/sub!
Registration/Compatibility/Licensing
====================================
WWIVMail/QWK and it's related files are NOT public domain or freeware.
The WWIVMail/QWK Mail Door is a copyrighted software product developed and
owned by Michael Leib.
The WWIVMail/QWK BBS executable is licensed "AS IS". Michael Leib
is NOT responsible for any damage to your system, software or your life.
There has been some concern with people who have been involved with
this project regarding compatibilty with their HEAVILY modified WWIV systems.
Although WWIVMail/QWK can ( and will ) work with modified userrec's, I have
fully tested this software with un-modified WWIV systems and have had
no difficulty. However, this doesn't mean your WWIV will behave nicely if you
have modified the way data is stored in the user's files( .dat, .sub, etc).
To get around this problem, I have no choice but to make the source code
available for you to compile with your vardec.h header file. At first I
really didn't want to do this but, in order to get everbody on the bandwagon
( as well as keep the spirit of WWIV alive), this seems the only fair
alternative..so, I have set-up the following standards:
Registration:
=============
Lifetime Use of WWIVMail/QWK Door ------------------- $25.00
Lifetime Use of WWIVMail/QWK Door Plus
Full Source Code ------------------- $35.00
(Compiles Under BC++ v2.0(or newer) and TC++ 1.0(or newer).
I feel these prices are fair with the current cost of the WWIV BBS
registration/source code at 80.00.(starting FEB 93). I also give you the
option of getting the source code or not...some of you may NEVER need it so,
why charge you for it!
WWIVMail/QWK is almost a BBS in itself..It has built-in Communications
routines, support for the upload and download of Public posts and E-mail,
Full MULTI-NET support, as well as the ability to scan the Transfer Section
for New Files. Also, starting with WWIVMail/QWK ver 4.3, it also has the
ability to import messages from non-WWIV BBS systems.
Now, why should I register?
1) WWIVMail/QWK is not crippled in any way. I have released it on trust.
I have, however, placed a key system in the door that places a 15 second
delay banner in all UNREGISTERED door versions and flags all posts in
the tagline as [EVALUATION COPY]. Please take the time to register if
you use this door, the cost is VERY low considering the time I have put
into creating it. I will respond to your mail the day I receive it
(see below for address and contact information).
WWIVMail and WWIVMail/QWK have been out for over 2 years. I have spent
literally hundreds of hours working on this project and adding support
(compatibility) for all of Wayne Bell's enhancements. Please support my
effort to enhance the capabilities of WWIVMail/QWK. I have shown that
a new release of WWIVMail/QWK ussually follows a WWIV release within
days of Wayne's availability (Wayne and I have a nice working relationship
and I usually get (I have in the past) the next version of WWIV weeks in
advance). We are currently discussing placing WWIVMail/QWK in as part of
the Accessory Pack for WWIV 4.23 (although, no decision has been made).
2) If you have modified the BBS's users files, the only way you'll get
it to run is to purchase the rights to the source code. At the end of
this file you will see a listing of the BBS files that WWIVMail/QWK uses.
You can then compile the door with your modified vardec.h/net.h files
and then WWIVMail/QWK will run correctly.
Starting with WWIVMail/QWK v4.0, I supply all the needed files to get
WWIVMail/QWK to run with a modifed userrec. However, if you have changed
ANY other structure that is in the list at the bottom of this file, you
will have to get the source. (See below for info on compiling your own
version of WWIVMail/QWK).
3) Sysop's who register always get priority regarding bug fixes and
enhancements....
4) The time I have spent in writing WWIVMail/QWK is obvious. Please support
my endeavor and push me to continue to write support programs for
WWIV. Among other programs created under my pen (actually, mouse!):
WWIVFile : v1.1 External Transfer Section File Manager.
Basically, an XTREE(c) Clone for WWIV Transfer Section
management.
Topten : v1.0 Lists the top Download Files from your BBS by section.
Master : v1.0 BBS Door for users to Download A Master File List.
(Obsolete now..but worth mentioning!)
Support
=======
1) Feel free to contact me via "The General" On Amber(#445@1)...
WWIV Home Board in Los Angeles, California.
Or
"Michael Leib" on Rambo-Scan (#11@8856)
2) Join the WWIVMail/QWK Support Sub on the WWIVnet.
Contact Rambo of Rambo-Scan BBS(#1@8856) to join. (818) 566-7912.
He will ALWAYS be runing the newest Beta of WWIVMail/QWK...
Beta copies may be picked-up (when available) to registered
WWIVMail/QWK Sysops from Rambo-Scan.
I call this board several times a week, if you post messages on
the WWIVMail/QWK sub, I will respond quickly.
Send registration (or comments) to:
Michael Leib
1740 N. Ontario St.
Burbank, Ca
91505
When you send your payment, please enclose:
1) The name of your BBS, as it is spelled (including capitialization),
in your init.exe program field.
2) The Sysop's Name for your BBS, as it is spelled (including
capitialization), in your init.exe program field.
3) The phone number of your BBS..so I can add your full information to
the REGISTER.LST file..
4) A net location where I can send e-mail to you with a registration
keyfile to disable the 15 second delay and the [EVALUATION COPY] tagline
on all uploaded posts/e-mail. If you registered w/ source option, I will
also let you know how you can obtain the source code for WWIVMail/QWK.
NOTICE...if you register WWIVMail/QWK with the source code option,
you will also need vardec.h, net.h, subxtr.h and subxtr.c from the
WWIV source code distribution package in order to fully build the
wwivqwk.exe executable(qwk.lib). These source pieces are available
from Wayne Bell when you register the WWIV BBS System and are not,
nor will ever be, distributed by me with my source code. You can,
however, use my qwk.lib to build your own wwivqwk.exe with a modified
userrec with no problem.
Comments
========
I currently support both working storage types of WWIV ver 4.22.
Storage Type 0 stores each message in seperate files with a common header
file, whereas Storage Type 2( the default and most common ) stores all
messages in one .msg file. Type 1 is not functioning in WWIV
(last time I looked into it), so, I also fail to fully support it.
The .QWK message structure is a WHOLE lot different then the
standard WWIV message base system. In order to get Messages to fit properly,
WWIVMail/QWK NEEDS to strip out all the WWIV color code sequences from
posts. Also, the time and date structure is different (written out rather
then military time standard); therefore, I have to convert those as well.
Also, it appears as though SOME .QWK readers can only support 78 characters
accross the screen and, in ANSI mode, WWIV can do the full 80. Therefore,
SOME ANSI posts may not come out correctly. There is nothing that
WWIVMail/QWK can do. This is a design limitation of the .QWK packet
structure(and SOME of the readers!). So, although you may not have modified
any BBS structures, some small MODS that display the above functions
differently then in the stock manner may cause weird characters (or say
the loss of a date field or the such) to occur. This is normal and there
is nothing to worry about.
E-Mail
======
Since E-Mail in WWIV doesn't have a Message Sub, I send all
Personal E-mail into Sub 0 in the .QWK Packet. This, in itself, doesn't
hurt anthing BUT, if your 1st Message Base cannot be read by a User
(They Don't Have Access To See It), then when they try to respond
to their e-mail, they will not be able( get some error in a .QWK
reader that the SUB doesn't exist). Therfore, I suggest that you make
your first Message SUB viewable by all. They don't have to be able to
Post on it, just read it. This has only been reported by One User, and,
there really isn't anything I can do about it. The workaround, for the
User, is to pick another SUB, then everything will work well. This is
a VERY rare problem, so, don't even worry about it but I did want to share
the information!!!
Set-Up
======
Ok, I assume that if you made it this far in the docs, I haven't
scared you away with all my talk of registration and compatibility.
1) Executable
Copy the file WWIVQWK.EXE to your main bbs dir.
(Where you keep your bbs.exe and config.dat )
WWIVMail/QWK ver 4.4 has the ability to auto-detect how many SUBS and
DIRS are configured for your BBS. Because of this, one .exe will work
for all WWIV 4.22+ installations.
This is the only file you will need.( See below for information regarding
the optional wwivmail.cfg file).
2) Make sure you always maintain a couple of free megs of disk space for
the .QWK packet creation( The user will be warned if disk space gets low ).
Since all upload and download packets are placed in the directory that
you have specified as your "TEMP" directory for WWIV, this is the place
that should have plenty of space....
I allow the Sysop to override the location where the temporary packet
resides. If you wish the temporary files that WWIVMail/QWK creates to be
placed in any other location besides the BBS "TEMP" directory, you may
set an environment variable to that location. In your autoexec.bat
(or in a .bat file that starts the BBS) put:
set wwivmail=xxxxxxxxxxxxxxxxxxxxxxxxxx.....
where xxxxxxxxxxxxxxxxxxxxxxxxx represents the drive and path where the
files will be placed.
Example: set wwivmail=d:\temp\files\junk\
(trailing \ is not needed..if you leave it off, I append it.)
I find, however, that the "TEMP" directory works quite fine for
most people.
3) Start the BBS and go into //chainedit:
A. Description : WWIVMail/QWK v4.4 .QWK Mail Door
B. Filename : WWIVQWK.EXE
C. SL : 10
D. AR : None.
E. ANSI : Optional
*F. DOS Interrupt: NOT Used
G. 300 Baud : NOT Allowed
*H. Shrink : Yes
I. Disable pause: No
The only things you have to worry about here are these 2 options;
F. => DO NOT have the BBS monitor dos calls....this is not needed
because WWIVMail/QWK has it's own com port initialization,
reads and writes.
H. => You must have the BBS Shrink..not because my program takes alot
of memory, but this is the only way in which WWIV will update
the qscan pointers...Don't worry, WWIVMail/QWK won't run if you
don't do this(and it will warn you).
4) Make sure you have a copy of ALL external programs in your path.
[Used to compress the packets before transfer and the transfer protocols]
WWIVMail/QWK's Use of External Protocols
========================================
You must have DSZ(c) in your path because WWIV has Xmodem and Ymodem
built-in.(by default in WWIV 4.22..although you can over-ride them).
WWIVMail/QWK doesn't...so, I use DSZ(c) to handle those two
basic protocols. After those two, WWIVMail/QWK will use the transfer
protocols as you have them set-up for the BBS(WWIVMail/QWK will use
the command-lines as they are in the INIT.EXE)(stored in nextern.dat).
This allows you to be assured that WWIVMail/QWK will run (while
transferring packets) EXACTLY like the BBS. Any special command-lines
that you had to implement for your high-speed modem or strange
configuration will be maintained in WWIVMail/QWK!. (Nifty Huh?)
Due to the above, You will need (For Sure) a copy of Omen Technology's
DSZ(c)in your path.(it need not be registered) (Available on almost any
BBS)
[Used to transfer the packet for the default xmodem and ymodem choices]
For your information, the %1 (com port speed) and %4 (modem speed)
are taken directly from chain.txt (see userrec.cpp for code) so the
external protocols will run the same as they do from within the
BBS.
WWIVMail/QWK's Use of External Compression Engines
===================================================
You will also need to have each compression program(.zip, .arc, etc)
that you have listed in your init.exe (config.dat) as supported on your
BBS in your path so the user can pack/extract the .QWK/.REP packets.
The user has the option of selecting a default choice of transfer
protocol and compression type. The list they choose from is DIRECTLY
made off of your configuration in the INIT.EXE(config.dat). The more
you put into the BBS, the more functionality that goes into WWIVMail/QWK.
The extent of these functions is only limited by you.
NOTE: These programs NEED to be a directory who is in your
"path=" statment in your autoexec.bat. If not( although these
programs may be in your main wwiv bbs directory) it doesn't
matter. I change directories to your TEMP area for processing,
so please have them in into your path. If not, WWIVMail/QWK will
spawn for the external protocol and will fail attempting to complete
the transfer or compress/uncompress the packet.
If you experience any problems with compression or extraction, please
investigate your command-line strings...all external programs that get
executed from WWIVMail/QWK have the command-lines written to the screen
and the sysop's log. Good chance any problems can easily be resolved
by changing the strings. These strings are taken directly as you have
them listed in the INIT.EXE fields.
NOTE: I have been asked by SEVERAL sysop's to note here that MANY of you
have "pkunzip -eo ..." in your INIT.EXE fields for extraction of
files from within the BBS. -eo IS NOT a valid argument for
PKUNZIP.EXE(c)(try it yourself from the DOS prompt...it's invalid!)
Where this came from I have no idea, but you need to modify that
or WWIVMail/QWK will NEVER be able to extract messages from your.REP
packet(REMOTE or LOCAL).
This is an easy fix..replace "-eo" with "-e -o" and eveything
should work correctly.
NOTE: Also, I have been asked to let you all know that WWIVMail/QWK is
not compatible with Wayne Bell's UNZIP.EXE shell for WWIV and
pkunzip.exe. This code (unzip) has been incorporated into WWIV 4.22
so unzip.exe is no longer needed for protection against hacking
of your BBS.
I suggest you use:
pkunzip -e -o %1 %2 >NUL
in your init.exe extraction field.I know this works.....
5) What files does WWIVMail/QWK Create?
As your users log into the Door and start selecting defaults
(tansfer protocol and compression options), a file named
wwivmail.usr will be created and placed in your wwiv main directory.
The size of this file will grow as more users begin to use the door.
Other then this file, everthing else that WWIVMail/QWK creates is
loacated in your TEMP directory location, so they get deleted after
every door session.
Starting in WWIVMail/QWK ver 4.3, information about the user's actions
in the chain are added to the current sysop's log. Therfore, you will be
able to see exactly what the user did while in the door and outside the
control of the BBS.
The name of the .QWK packet for your BBS is created using the BBS NAME
field from your INIT.EXE(config.dat). The packet name is based off of the
first eight characters, with any blanks being replaced by underscores.
The only problem I have encountered with this simple idea is one BBS that
had ">" 's in the name....this CANNOT be used to create a valid file
because it represents a standard dos redirection of output. So, a board
name of say:
Rambo Scan BBS would become=> RAMBO_SC.QWK
That's it!!!!!! (simple in comparision to other bbs chains, huh?)
5) OPTIONAL
========
WWIVMail/QWK has MANY Sysop Definable options. To set them, you need
to create a file named wwivmail.cfg and place it in the main BBS
directory (along with wwivqwk.exe).
Previously, prior to WWIVMail/QWK 4.3, I included a program named
wwivcfg.exe which created wwivmail.cfg. After consideration, I have opted
just to state the fields in the file (and the format) and save at least
50k in the distribution file archive...
Let's look at the wwivmail.cfg that is distributed in the WWIVMail/QWK
distribution packet:
Burbank, Ca
100
200
300
400
500
600
700
c:\wwiv\gfiles\welcome.ans
c:\wwiv\gfiles\newsinfo.ans
NO
3
Obviously, you will want to modify these fields! But, here is what they are..
LINE1: The CITY/STATE where your BBS is located.
LINE2: Maximum TOTAL messages that can be downloaded at 300 Baud.
LINE3: Maximum TOTAL messages that can be downloaded at 1200 Baud.
LINE4: Maximum TOTAL messages that can be downloaded at 2400 Baud.
LINE5: Maximum TOTAL messages that can be downloaded at 9600 Baud.
LINE6: Maximum TOTAL messages that can be downloaded at 14400 Baud.
LINE7: Maximum TOTAL messages that can be downloaded at 19200 Baud.
LINE8: Maximum TOTAL messages that can be downloaded at 38400 Baud.
LINE9: Full Path to BULLETIN #1 (LEAVE ANY OF THESE BLANK TO IGNORE)
LINE10: Full Path to BULLETIN #2
LINE11: Full Path to BULLETIN #3
LINE12: Full Path to BULLETIN #4
LINE13: Full Path to BULLETIN #5
LINE14: Full Path to BULLETIN #6
LINE15: Full Path to BULLETIN #7
LINE16: Full Path to BULLETIN #8
LINE17: Full Path to BULLETIN #9
LINE18: Full Path to BULLETIN #10
LINE19: Full Path to NEWSFILE
LINE20: NO File EXISTENCE checked? (LEAVE BLANK TO IGNORE)
If you put a NO here, the existence of files on your
system will not be checked; thefore, the user will never get
a N/A filesize. This is handy if you have a CD-ROM drive
because seeking file existence is slow and can take a LONG
time. If you have a CD-ROM, I have been told(I don't have one)
that this MUST be set to NO. If you don't have one, just leave it
blank.
LINE21: Number of GOLD pieces given to a user for each uploaded message
through WWIVMail/QWK. Leave blank if you don't use GOLD on your
system or don't wish to reward the user. (You could also put 0
here if you wish).
Remember, this configuration file is totally optional, and is needed only
if you wish to set these options. Starting with WWIVMail/QWK v4.3, the
user has the option to download or ignore the BULLETINS and NEWS files,
but I think it wouldn't hurt to set them up. You probably want to have
these fields point to some of your G-Files...If you place a bad path
or a path to a file that doesn't exist, the entry will just be ignored.
Also, these entries DO NOT need to be padded out...just type them in
however you like...The only important thing is that the correct entry is
on the right line.
Command-Line Options
====================
WWIVMail/QWK supports several command-line options...
1) "wwivqwk local":
WWIVMail/QWK can be run local but you need to use a special command-line
argument. This is due to the need for carrier detect under normal
conditions...if you don't use the correct parameters, it will drop you
back to dos. Type 'wwivqwk local' and the door will go into local mode.
For Downloads: Go through the menus as you would if you were on-line!
A valid packet wil be created. Then, take a look in your
directory that is specified in your bbs configuration as
your TEMP dir. The download packet will be in that
directory.
For Uploads: Create a valid upload response packet and place that packet
in the TEMP dir (or location that you specified for packets
to be placed). Go through the door as normal, and the
packet will be detected and imported....
2) "wwivqwk nowrite":
WWIVMail/QWK reads and writes to MANY WWIV BBS data files (see below
for listing). If you aren't sure whether or not you have modified the
ways your modifed BBS writes to those files, you can try WWIVMail/QWK
with the "nowrite" option. This will cause the program to ONLY read
all files (except those which it creates). Doing this will save your
data, and you can see how the door behaves on your system. This is
basically an evaluation mode.
Uploading Messages with this option enabled will not work because
it won't do anything ( no way to save your posts ).
3) You can also use these parameters together, such as:
"wwivqwk local nowrite" or "wwivqwk nowrite local"
4) "wwivqwk export=xx":
A key new feature in WWIVMail/QWK ver 4.4. First let me say, this option
also enables the "local" parameter. xx represents a user number
(1 -> whatever) and will extract all un-read messages for that user.
So, "wwivqwk export=99" will extract all un-read posts for user 99,
make a .QWK packet, update user 99's Qscan pointers and exit WWIVMail/QWK.
You could, along with the next command-line argument(below), EASILY
network your WWIV system with NON-WWIV BBS systems!
The trick here is to reserve a user as your "NETWORK" user and use that
account as the key into your BBS.
Most of you (98%) will NEVER use this....so, you don't have to worry
about it...Along with the option below, this could tame the wildest
of the network hounds out there...But, Until WWIV supports anything other
then it's own network strategy, this is a neat way to hook your BBS upto
FidoNet(etc).
5) "wwivqwk import=xxxxxxx.qwk":
A key new feature in WWIVMail/QWK ver 4.3. First let me say, this option
also enables the "local" parameter and loads the user information from
user #1. This assumes the Sysop is user #1 and has full access to all
pieces in/of the BBS. If user #1 isn't the Sysop, you MUST set that
account up for the correct access to the messages subs you want to import
into. This is to say, all security is still maintained, and if user #1
can't post on a sub, neither will WWIVMail/QWK in import mode.
So, what the heck does this option do?
One of the neat features of the .QWK packet is that the file structures
of messages.dat (in a .QWK packet) and the .msg file in a .REP packet
are exactly the same. Due to this feature, WWIVMail/QWK has implemented
an automated method of importing messages from a downloaded .QWK packet
and the ability to bring those messages directly into your BBS. This
feature allows you to network your BBS to non-WWIV boards easily through
the use of a .QWK mail door on any BBS and through WWIVMail/QWK on your
end.
How does this work?
1) Download a .QWK packet from a BBS and place that packet in your
TEMP directory (or where "set wwivmail=" is set to). You can either
do this manually or set-up a script to run remotely via a
communications program to call and get your messages.
2) Invoke "wwivqwk import=xxxxxx.qwk" from the main BBS directory
(where xxxxxx is the name of the packet you want to import).
If you use the wrong name, the file isn't a .QWK packet or no
messages.dat can be found, WWIVMail/QWK will exit normally and
inform you that a messages.dat couldn't be found.
3) WWIVMail/QWK will extract messages.dat from the packet and
process the file for import. User #1's default extraction
protocol will be used for the operation. Each message will be
posted in the default sub number it came from off the BBS is was
downloaded from, unless you over-ride that conference number
(see below for explanation on how to do this). Therefore,
if the message was on sub number 12 on RAMBO-SCAN BBS and you
import it, it will be posted on your sub number 12. If you don't
have a sub 12, or user #1 doesn't have access to sub 12, the
message will be skipped. This can also be a problem when you try
to import messages from a 200+ conference Non-WWIV BBS and try to
get them to all import into your 32 or 64 sub WWIV BBS! (see below
for explanation on how to get around this).
4) After all the messages are uploaded, you will be given the total number
of messages imported. Unlike normal operation, user #1 will NOT have
his/her account updated..so all imported messages will be new when
the board is next scanned. Also, the WWIVMail/QWK tagline will NOT be
added to the end of each message and the real name of the person who
wrote the post will be used, not the name of user #1. Also, internally
to WWIV, user #1 will not be tagged as the uploader of the post. This
way, user's who 'A'uto-Reply to these imported messages won't have them
all (e-mail reply's) come back to the sysop's account (which would
probably make you just a little mad!).
After completion, messages.dat is deleted.
How do I handle over-riding the sub number?
For each .QWK packet from different system's, you'll probably want
a different conference mapping system. To facilitate this, you need
to create seperate "map" files for each system you plan on importing
messages from. Once again, you ONLY need to do this if you don't like
the way the conferences map, or you want to bring messages in from
conference numbers greater then the available subs on your WWIV bbs.
Let's continue to use the RAMBO-SC.QWK example from above.
Say you call Rambo-Scan BBS and you want to bring his sub's 5 - 10
into your message base 4, his subs 11 and 12 into your message
base 7 and his base 200 into your message base 15...that is:
5 4
6 4
7 4
8 4
9 4
10 4
11 7
12 7
200 15
And that's how your "map" file would look. So, to finalize this..
In order to do the above mapping of his subs into your BBS, make a file
named RAMBO-SC.MAP and create it so it has 2 columns of numbers. The
first is his sub number(s) that you wish to over-ride their mapping
order and the second is where you want those conferences to "map"
into(his sub 5 will map into your sub 4, etc). These lines of numbers
(wich a space between them) is how the map file would look for each
conference you wish to "map".
Then, you can place the RAMBO-SC.MAP file in your main WWIV BBS
directory(along with wwivqwk.exe) and it will be used when you
import messages.
You need to make a xxxxxx.MAP file for each xxxxxx.QWK packet you
plan on importing from(and want to control what messages go where).
I personally like the idea of making a sub with the title "Messages
from Rambo-Scan" and importing all messages from RAMBO-SC.QWK into
one message sub....but, that's me!
(example: all of his 10 subs into your sub 30)
1 30
2 30
3 30
4 30
5 30
6 30
7 30
8 30
9 30
10 30
One last note here....This process can be VERY time consuming..so,
don't be alarmed if it takes awhile to run. However, as each message
is processed, little "."'s will print on the screen to let you know
the system didn't take a dive!
WWIVMail/QWK and Networked Subs
===============================
WWIVMail/QWK has full built-in support for Networked Subs. That is to
say, WWIVmail/QWK is a full extension of your BBS. If a user posts on a
Net Sub, that post WILL go out on the network (or on several if the network
SUB is Gated..WWIVMail/QWK creates the proper pgate.net file as well!). This
is acomplished in one of two ways:
1) If the sub is marked as Sysop Validate = YES, WWIVMail/QWK will place
the message in the local Sub and mark it as pending for net status.
When you, or anyone with access to validate, validates the message,
WWIV will process the post and add it to the p1.net file in your DATA
directory(or whichever directory is set-up under a multi-net environment).
When the user logs off, WWIV will run the NETWORK program(s) on that file,
and the messages will be sent out on the net.
2) If the sub is marked as Sysop Validate = NO, WWIVMail/QWK will place
the message in the local sub AND will CREATE/ADD TO the p1.net file.
As in the case above, WWIV will process the p1.net file when the user
logs off the board, and the message(s) will be sent out on the net.
I create the p1.net file EXACTLY as Wayne Bell does, so the integrity of
all net actions will be maintained.
This is also how e-mail networking is set-up. WWIVMail/QWK creates the
p0.net file, and when the user hangs up, WWIV does a clean_upnet() on
all the p*.net files. At this point, all e-mail destined for the NET
will be sent.
Here is an example on how NET E-Mail looks on the receiver's end.
I sent this personal e-mail (my config.sys), from my account on Rambo-Scan
to my account on Amber (#445@1 was how it was addressed).
This is what I got...
(1/1): Net E-mail test
Name: Michael Leib #11 @8856
Date: Thu Dec 25 08:36:15 1992
From: WWIVnet - Rambo-Scan BBS (Southern California) [818-566-7912]
Response To: #445@1
Does this get through..
shell=c:\drdos\command.com /P
DEVICE=C:\QEMM\QEMM386.SYS RAM
device=c:\qemm\loadhi.sys /r:1 c:\utils\aspi2dos.sys
files=3
hibuffers=20
fcbs=1,0
stacks=0,0
hidos=on
Michael
---
■ SLMR 2.1a ■ All hope abandon, ye who enter messages here.
WWIVMail/QWK 4.4 [REGISTERED]: RAMBO-SCAN BBS - @8856 on WWIVnet
.....And this is what I expected.
Also, after I read the mail, I was notified that it was read on Rambo-Scan
just as it was any other piece of E-Mail.
Starting with WWIVMail/QWK ver 4.2, I support the optional Multi-Net
NETWORKS.DAT file used by WWIV ver 4.21a. WWIVMail/QWK will send Net posts
and E-mail out on whichever NET is active for the Sub in question.
The format users MUST use to send E-Mail via WWIVMail/QWK is:
#xxxx@yyyyy
where xxxx is the user's number and yyyyy is the Net address....
The E-Mail Net address is the address on whichever NET the subboard is on..
(I may, in the future, add support for sending e-mail to people's NAMES
as well as mail forwarding....).
===============================================================================
Thanks go out to:
Rambo........ (Of Rambo-Scan BBS ) who allows me the time and resources
of his BBS and continues to be the main testing ground for
WWIVMail/QWK. Without him, I'd probably kill this project.
Foundation....(Of Dark D.) who helped me design the network support.
Crashed him out a few times too...Was also his idea
for the IMPORT mode...thanks for the great ideas!
JAFO..........(Of Blue Thunder BBS) who modified the source to get it
to work with Turbo C++ as well as BC++. Common source
for all current production Borland C compilers. Thanks...
Also helped me out bigtime with NET support in WWIVMail/QWK
ver 4.4. (DUDE, thanks for the help, BIGTIME....!!!
Couldn't have gotton 4.4 together without you)
Wayne Bell....Gave me permission to use subxtr.c/.h in my code and has
been very helpful along the way with questions. Give credit
where credit is due...
Rick Gale.....Thanks guy for helping me get WWIVMail/QWK ver 4.4 running
on WWIV 4.22...See ya in again in Burbank next Xmas!
And all the people who have commented, helped in the coding, and design of
WWIVMail/QWK. Also, thanks to those authors who compiled all the information
I found in various places describing the structure/contents of the .QWK
packet.
===============================================================================
Listing Of Vardec.h/Net.h Ties
==============================
In order for WWIVMail/QWK to run correctly on your system, you must
have NOT modified any of the Files listed below. If you have a modified
bbs but have not made any changes to the vardec.h include file, then you
should be fine( And forget you ever read this! ). Otherwise, do a comparision
to the stock file (vardec.h/net.h as Wayne Bell created it) to make sure
these Files aren't stored in a different way. If they are, then you will
need to register your copy of WWIVMail/QWK and obtain the source code to
compile with your modified header files.
FILES
=====
BBSDATA.NET
CHAIN.TXT
CONFIG.DAT
DIRS.DAT
directory.filename.DIR ( all .DIR files )
EMAIL.DAT
MODEM.DAT
N*.NET
NEXTERN.DAT
NN*.NET
P0.NET
P1.NET
SMW.DAT
STATUS.DAT
SUBS.DAT
subboards.filename.DAT ( all .DAT files )
subboards.filename.SUB ( all .SUB files )
xtrasubsrec (subs.xtr)
===============================================================================
What Do I Do if I have a modifed USERREC?
Although I have felt in the past that registerred user's did have userrec
support, since they legally got the source code; but, some people couldn't
evaluate the product before paying for it. In order to fix this, and give me
equal advantage with any competetors (current or future), WWIVMail/QWK can
now be compiled and linked via an object-oriented approach to match any
userrec changes that you may have made. Any changes to the BBS structure,
other then the userrec, however, will still require you to register and get
the source. I hope by adding this feature that I will have satisfied many of
your needs and will have greatly enhanced the use, compatibility and quality
of the product.
REMINDER: You ONLY need to do this procedure if you have modifed your
user.lst. If not, use the .exe included in this .zip file....
It was made EXACTLY the same way as you are going to make yours(except with
a stock vardec.h)...I used this .lib as well!
Needed Files:
=============
QWK.LIB WWIVMail/QWK LIBRARY TO LINK WITH USERREC.OBJ
QWKBCC.BAT .BAT FILE TO COMPILE AND LINK YOUR VERSION OF WWIVQWK.EXE(BC++)
QWKTCC.BAT .BAT FILE TO COMPILE AND LINK YOUR VERSION OF WWIVQWK.EXE(TC++)
RESPONSE RESPONSE FILE USED BY TLINK.EXE FOR LINKING OPTIONS/.OBJS/.LIBS
USERREC.H HEADER FILE FOR USERREC.CPP
USERREC.CPP CPP FILE TO COMPILE WITH YOUR USERREC AND LINK WITH .LIB
1) Get your programming environment set-up.
A) Copy the qwk.lib into your .lib directory.
B) Make sure your tools are in your path (bcc v2.0(or higher) or
tcc v1.0(or higher) and tlink).
My Tools: bcc.exe ver 3.1
tlink.exe ver 5.1
tlib.exe ver 3.02
This is what was used in the making of WWIVMail/QWK v4.4.(stock)
C) You will HAVE to modify the .bat file and the response file
to set-up the paths for the include and library directories
on your system...
ie; -Ie:\BC31\INCLUDE must be changed to match your system.
In qwkbcc.bat OR qwktcc.bat--------|
|
bcc -O2 -c -G -ml -N -Ie:\BC31\INCLUDE userrec.cpp
In response---|
|
/x/c/LE:\BC31\LIB c0l.obj+
userrec.obj
wwivqwk
wwivqwk
emu+
cl+
mathl+
qwk
2) Make sure your userrec.cpp and userrec.h files (this file contains the ONLY
places in WWIVMail/QWK where your userrec is accessed) are accessable.
Userrec.cpp uses vardec.h as well as userrec.h; therefore, make sure
your current modifed vardec.h header file is either in the current
directory or in the directory you have indicated as your INCLUDE
directory. Also, do NOT change any definitions in the userrec.h header
file...because all the code in the .lib was built using those
definitions.
3) Type qwkbcc.bat(or qwktcc.bat). It will attempt to compile (no link)
your usserec.cpp into userrec.obj using the large memory model.
You should get NO errors or warnings. If you do, try again till it
compiles clean.
4) After it completes a clean compile, it will execute the second line in the
.bat file and attempt to build a wwivqwk.exe. If all your .lib files can be
found, your done. If not, you will get some unresolved external errors
during the link. Fix them (path isn't right...can't find the file...etc)
and THEN you are done. Copy the linked wwivqwk.exe to your WWIV main
directory and.....Enjoy.
(NOTE:...since (starting in WWIVMail/QWK ver 4.4) I have added the use
of a RESPONSE file for the definitions needed by TLINK. You can
modify that file (without running over the 128 character
command-line limit) to have TLINK look at certain locations
for your .OBJs and .LIBs...ie, you could do:
/x/c c:\compilers\tc10\lib\c0l.obj+
d:\wwivmail\userrec.obj
wwivqwk
wwivqwk
c:\compilers\tc10\lib\emu+
c:\compilers\tc10\lib\cl+
c:\compilers\tc10\lib\mathl+
d:\wwivmail\qwk
And that should solve any problems....
Revision History
================
4.4...(02/01/93)
Compatibility release for WWIV ver 4.22+. WWIVMail/QWK ver 4.4
will NOT run on any WWIV BBS software versions prior to v4.22+.
WWIVMail/QWK ver 4.3 will work fine with these versions, however.
Too many changes internally to the BBS to continue to support two
versions. So, as Wayne Bell has changed, so has WWIVMail/QWK.
=> WWIVMail/QWK now uses the NEW userrec structure
and USER.QSC file introduced in WWIV 4.22.
=> WWIVMail/QWK now supports upto 1024 SUBS and DIRS.
=> WWIVMail/QWK now supports SUBS.XTR.
=> WWIVMail/QWK now supports Gating for networked SUBS.
(WWIVMail creates the pgate.net file in the proper
network directory).
1) Totally re-wrote a ton of code...some stuff looked like it
could be done much better(two years after I wrote it!)
(At least I'm honest... :>)
2) The spacebar Abort during Message Scanning is MUCH more
responsive now...you don't have to wait till the sub in
question is done..it jumps out right away.
3) WWIVMail/QWK now uses (yes, like it used to way back in the
old days!) the qscn pointers the user has set-up inside the
BBS. This is because:
1) It's easier for me to keep the pointers correct when the
Sysop ADDs or DELETEs subs...Wayne updates the entire
user.lst when you do that...since I don't have that luxury,
I have to figure out what happenned when the user enters
the DOOR. This is time consuming, and would only get
worse with 1024 subs.
2) I have had TONS of "enhancement" requests for the way the
qscn tags "should" work...I think just letting the user
pick them once (inside the BBS) is easier and less hastle
for them....and, they will always be correct no matter
what happens.
NOTE: The ADD/DROP feature of many .QWK Readers is STILL
supported by WWIVMail/QWK and will change the QSCAN pointers
for WWIVMail/QWK as well as those inside the BBS.
4) Added a two-second delay after every message uploaded so
the user can see if the mail/e-mail was correctly sent.
(Sysop Requested Enhancement)
5) Since the GOLD field is now standard in the WWIV 4.22 userrec,
WWIVMail/QWK allows the Sysop to specify the number of gold
pieces given to the user for each message uploaded through
WWIVMail/QWK.
(Sysop Requested Enhancement)
6) Sysop's can now turn-off WWIVMail's attempt to see if a file
exists during the NEWFILES.DAT scan...I would only do this
if you have a CD-ROM (which is why this was put in).
(Sysop Requested Enhancement)
7) Like the last release (4.3), I have now added a command-line
argument to help facilitate WWIV networking with non-WWIV BBS
systems via the .QWK packet. See documentation (above)
for "export=xxx" definition and detailed explanation of this
function.
(Sysop Requested Enhancement)
8) Appended WWIVMAIL.REV to the end of WWIVMAIL.DOC.
9) Added support for TLINK's @response file format. A couple of
Sysop's had very LONG paths and had some problems linking
WWIVQWK.EXE.
(Sysop Requested Enhancement)
10) It was brought to my attention that some .QWK Readers DON'T
follow the standard QWK convention to signal if a post
was private E-Mail or not...they should be marked as "*" but,
some Readers mark the posts as "+"!!!! So, now WWIVMail/QWK
accepts posts tagged as "*" OR "+" as private E-Mail...
(For example, Blue Wave v2.10 does this!)
(Sysop Requested Enhancement)
11) When you scan for new messages, the Full NETWORK NAME is
displayed on the screen for each sub(if it is Networked) or
if it is LOCAL.
4.31..(11/10/92)
Made some changes to speed up the NEWFILES scan on CD-ROM/LARGE
BBS Systems. Now takes about 1/4th the time is used to!
Only released .LIB and .EXE files.
4.3...(11/01/92)
==================================================================
NOTICE...this is more than likely the LAST release of WWIVMail/QWK
that will be compatible with WWIV versions before 4.22( when it
comes out next year). From what I understand, the userrec and
qscan pointer information will be stored in a radically different
manner so, trying to maintain backwards compatibility will almost
be impossible. If you are using WWIV BBS versions before 4.22,
WWIVMail/QWK ver 4.3 is the correct version for you. When you
upgrade to WWIV 4.22 (or higher), you will have to get my
latest(4.4 or whatever newer version is out at the time).
==================================================================
1) Bug Fixes(once again..ultra minor):
A) If you use the WWIVMail= set statement, WWIVMail/QWK
wasn't checking if that was a valid TEMP directory.
Now it substitutes for syscfg.tempdir(in WWIVMail)
and is checked.
Fixed.
B) Fixed a potential crash when user uploaded messages
to a sub that had no physical .sub and/or .msg file
on disk. Fixed.
C) New File Scan had some problems( wasn't finding ALL new
files). Fixed. Scans properly now and still maintains
correct security (DSL, DAR and AGE) checking (as before).
2) Moved WWIVMail/QWK to BC++ v3.1. Compiled all code with .cpp
strict type checking and cleaned up some portability issues.
Added -O2 optimization to compiles. Re-wrote SOME code in
C++.
3) WWIVMail/QWK now supports upto 30 external protocol choices.
6 just wasn't enough. This limitation was left over from the
old WWIVMail days(Pre-QWK). Resolved.
4) Added e(X)pert user mode. When turned on, no menus appear.
Just like the BBS.
5) Added support for Sysop's Log. Most operations will be
reported to the current Sysop's Log..thus giving a detailed
report of what the user did while in the Mail Door.
6) Added unique function for .QWK message importing. Allows
WWIV networking with non-WWIV BBS systems via the .QWK packet.
See documentation (wwivmail.doc) for "import=xxxxxxxx.qwk"
definition and detailed explanation of this function.
7) Added user option to download/not download BULLETINS/NEWS files.
8) Added user option to update/don't update Q-SCAN pointers after
packet transfer - requested function by several users.
9) I am no longer going to release WWIVCFG.EXE..I give instructions
on how to make the file easily by hand. Was a little overkill for
a simple task.
10) When a user downloads a packet, it now tells him/her the
EXACT filename that is going to be sent and the size(k) that
is to be expected at the end of the transfer.
11) Re-did much of the WWIVMail.doc file.
4.2...(08/12/92)
1) Bug Fixes:(ultra minor - 4.1 was a solid release)
A) If an External Protocol Exists (Is Listed), but the Sysop
Didn't List BOTH an Upload and Download Command-Line in
Init.exe, then WWIVMail/QWK Will NOT try to Spawn the
Protocol.
B) Brightened up Dark Blue Ansi..Wasn't very readable on
CGA screens.
C) The Door still tried to unpack the .REP packet even if the
upload event failed.(Transfer) Now it doesn't.
D) WWIVMail/QWK now gets the %1 command-line parameter
for external protocols(com speed) from CHAIN.TXT rather
then from MODEM.DAT.
2) Added (T) and (U) Keys to Q-Scan Configuration Screen.
User Can Now Tag or Un-Tag All Available Subs With One
Keystroke.
3) Cleaned up event-handling so it falls through one place.
Added local keyboard input while users are on-line. Now Sysop
can enter input for confused users.
4) Made one .exe that supports both 32 and 64 Subs. Also, I now
only need to distribute one .lib for modified userrecs. Did
this by taking advantage of syscfg.userreclen and building the
.exe with #ifdef EXTENDED turned on.
(Thanks to Wayne Bell for suggesting this to me!)
5) Users can now ADD or DROP subs for scanning by sending mail
to the door (WWIVMAIL) with the subject of ADD or DROP.
SLMR's(c) ADD/DROP feature is also supported.
6) With a user toggle on, WWIVMail/QWK will now map WWIV color codes
into default ANSI colors. This maps each of the stock seven WWIV
colors into their default ANSI representations.
7) Added changes to support Multi-Net Sub Listings(.age field) in
WWIV4.21a.
WWIVMail/QWK ver 4.2 will still work with previous version of WWIV,
however.
8) Added FULL NET support for WWIV4.21a+ so WWIVMail/QWK can, and
will, use NETWORKS.DAT to send public and private NET messages
out on the proper Network for the Sub. If NETWORKS.DAT is not
available, WWIVMail/QWK will work just as in previous versions,
defaulting to the \DATA directory for network files.
9) If the Download of a packet fails, the user will be prompted
if they want to try again, or Quit back to Main Menu. If they
try again, WWIVMail/QWK will NOT need to re-scan the subs and
re-pack the packet(uses the same packet again).
10) Changed Tag-Line to support REGISTERED/EVALUATION status and
listing of what network the sub is on.
11) BATCH MODE via REMOTES.DAT is 3/4 implemented. Will be available
and documented in the next release of WWIVMail/QWK.
4.1...(06/22/92)
1) Bug Fixes: (more then ever - because more people are using
the DOOR then ever before!)
A) Fixed Local Q-Scan Sub Tag/Un-Tag Problems by totally
re-writing the way WWIVMail/QWK handles Q-scan pointers.
B) Some boards had all uploaded posts being tagged as
<<UNKNOWN>> - Fixed.
C) Changed color scheme...some people didn't like it.
I think this is a little more pleasant.
D) .daten fields for net posts were not being set correctly.
Fixed.
E) Added Qmail(c) Compatibility banner to first message
in messages.dat. Never was a problem, except for an
Amiga .QWK reader author (who has no product yet).
F) Re-worked some of the E-mail upload code.
This has now been EXTENSIVLY tested. E-mail uploads
will no longer be a problem. Both local and NET.
G) Changed User Interface so it is more intuitive.
H) Fixed mail waiting field...wasn't updated correctly after
d/l ing your mail.
I) Some E-mail downloads had text cut-off at about
20 lines...Fixed.
J) Fixed XMODEM uploads on high speed modems..my commad-line
was off (left off the SPEED parameter).
2) Each user in the door now has a user record - makes it easier
to facilitate batch mode (when I get it in).
3) WWIVMail/QWK now uses a default transfer protocol. Easier
door usage.
4) Added Upload and Logoff Menu Option.(By Request)
5) First-Time users now get a Welcome banner with a few hints
on using the program.
6) Q-Scan pointers and sub numbers are now stored/manipulated in
absolute terms, not relative. Makes working with them easier.
This also allowed me to fix the shifting of user's qscan tag
picks when the sysop changes subs(add or deletes them). They
now get adjusted(if need be) every-time the user goes into
the door.
7) WWIVMail/QWK now supports all compression types (.zip, .arc, etc)
that you have set-up in your config.dat(init.exe) for the BBS.
The user can pick a default and it will be used every-time he/
she uses the door.
4.0BetaIII.(05/01/92)
1) WWIVMail/QWK now supports modified Userercs. See WWIVMail.doc
for information on the steps needed to build your own
WWIVMail/QWK .exe.
2) When WWIVMail went .QWK, the packet structure changed and so
much of the ANONY support was lost( it used to be in WWIVRead).
I have re-implemented the ANONY support for public posts.
3) Fixed a scanning bug in the CenterLine support...people actually
have macros that expand to over over 80 characters long.
4) Fixed a couple of cosmetic featues(external/internal).
A) Some subs were not being marked as Local/Net correctly.
B) Cleaned Up Some Interior Code and shrunk the stack.
5) Implemented a User option to allow user to leave e-mail on the
BBS, even after being downloaded (not deleted).
(This used to be a scanning option, but was removed when the
LOGOFF option was added. Solved by making this option... by
user request I put-back in).
4.0BetaII..(04/09/92)
1) Created a 32 and 64 SUB version. Distributed source
includes #ifdef defines to create 64 SUB version.
2) Compiled with WWIV v4.21's Vardec.h/Net.h
3) Changed NET support to implement NET changes in WWIV4.21
(WWIVMail/QWK WILL still work with WWIV 4.20).
4) Cleaned-up a few error checking routines (file handles).
5) Changed Option 2) To Allow D/L and Logoff From The BBS
4.0Beta ...(03/22/92)
1) By Popular Demmand:
A) WWIVMail now conforms to the .QWK Q-Mail(c) packet
format. User's can now use any of a number of .QWK
mail readers to process messages.
WWIVMail is now known as WWIVMail/QWK.
B) WWIVRead is No Longer Needed.
C) WWIVMail/QWK now supports the download and RESPONSE to
private e-mail.
2) Removed All Mention of WWIVRead in the WWIVMail executable
and support files.
3) Created WWIVCFG.EXE: allows Sysop to configure Bulletin and
Mail paths for WWIVmail/QWK. Also incorporated previous
WWIVMAIL.CFG baud rate information into confoguration program.
4) Added Support For User.Lst Record file to have the total number
of posts reflect those uploaded through WWIVMail/QWK.
( For accurate PCR ratio computation )
5) WWIVMail/QWK now echos prompt responses locally as well as
remotely.
6) Added "nowrite" command-line option to ensure no BBS data files
can be corrupted during Sysop evaluation.
7) Re-worked carrier detection. Now cleaner, quicker and more
accurate.
8) Re-worked Net support. If sub ISN'T marked as "Sysop Validate",
WWIVMail/QWK will create the p1.net file...WWIV will run
NETWORK on the p1.net file when the user logs off. If sub is
marked "Sysop Validate", the message will be sent out on the net
when the Sysop/Co validates it.
Users can now also send e-mail over the net using the
#xxxx@yyyyy to: line.
3.0 ...(02/01/92)
1) Bug Fixes:
A) Fixed bug with aborted transfers still having the user's
Qscan pointers being updated.
B) Fixed a bug with scanning of subs...was only looking if
the user's SL and Age were > then the minimum
requirements..Changed to the proper >= check.
C) Fixed SMALL bug with extra characters being displayed
in baud rate data in user screen.
D) Fixed bug for some exit paths where interrupt
communications vector wasn't being removed.
May have caused some BBS lock-ups in the 2.0 and 2.1
versions.
E) 1) Re-wrote many routines for speed.
2) Re-wrote many routines for size.
3) Changed a load of global parameters to passed pointers/
variables for cleanliness and readability.
F) Cleaned-up User Interface design and expanded On-Line
Help. Also removed status check box when WWIVMail
is started.
G) Modifed WWIVRead for cleanliness and compatibility.
Hopefully, this will be last release of WWIVRead...
WWIVMail(3.X) is going to conform to the .QWK packet format.
2) Changed Tag-Line Import From WWIVRead to WWIVMail.
Now lists the system name and (if exists) your system number in
the Tag-Line.
3) Added support for modem hardware flow control.
4) Added abilty for User to abort the packet scanning.
5) WWIVMail now uses the Command-lines for external protocols
as the Sysop has them listed in the BBS INIT.EXE program.
Up to six External protocols can be used in the Mail Door.
(See WWIVMail.doc for documentation).
6) WWIVMail now allows users to have seperate Q-Scan sub tag
information outside of the one's for the BBS. If the user
doesn't create seperate one's (stored in wwivmail.usr), then
WWIVMail will continue to scan the subs as it did before.
7) Removed the disk size check routines from WWIVMail. If WWIVMail
cannot perform and task( write to disk or compress the packet)
the user will be notified and he/she will not be allowed to
continue in the door.
2.1 ...(6/25/91)
1) Bug Fixes:
A) Fixed the ability to have registration file be read-only.
B) Fixed bug in changing directories to paths with explicit
drive specifications.
C) Pointer error which caused system crash when some systems
uploaded messages back into the BBS. (Memory Allocation
Error).
D) Fixed bug with checking time-out period if user fails
to respond ( at some prompts ).
2) Added environment flag to override packet creation in BBS Temp
directory.
3) Added WWIVMail.cfg file for Sysop control over number of messages
downloaded at various baud rates.
4) Personal E-Mail is also extracted and packed for download.
E-Mail Pointers Updated / Original user Notified of mail received.
5) Changed User Interface to show last-read/max number of messages
while extracting messages from bases.
6) Changed User interface to show Local / Networked Subs.
7) Reader now allows *.wwX where X can be any number. Therefore,
your users can have multiple packets and respond to them all by
uploading only one .rsp packet.
8) Uploaded Messages now respect Unvalidated flags for Net/User
restrictions.( Sysop Validation ).
9) Placed a message stating the exact expected upload packet filename
before shelling for upload transfer. Seems some users were confused
about the naming conventions.
2.0 ...(5/20/91)
1) Added the ability for users to upload posts to the BBS through
WWIVMail.
2) Upload and download temporary packets are now stored in the
directory that the sysop has specified through INIT as being the
TEMP dir for the bbs. ( Usually \wwiv\temp, but I read this from
config.dat so you can place it wherever you like).
3) Fixed a bug with spawning for dsz/pkzip on some xt systems.
4) Purchased a Communications library to handle the comm writes/reads
and initialization.
1.1....(3/18/91)
Changed the packet format( Users WILL need v.6 or higher of WWIVRead
to read packets created by 1.1 of WWIVMail). This was done for
1) User Security( parts of the userrec were downloaded in 1.0)
2) To remove Vardec.h links in the WWIVRead module.
Packet will now be smaller.
1.0....(2/1/91)
Initial Public release (2/1/91)